<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>perlandroid - Perl under Android - Perldoc Browser</title>
    <link rel="search" href="https://perldoc.perl.org/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser">
    <link rel="canonical" href="https://perldoc.perl.org/perlandroid">
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" />
    <style>
      body {
        background: #f4f4f5;
        color: #020202;
      }
      .navbar-dark {
        background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%);
        filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0);
        background-repeat: repeat-x;
      }
      .navbar-dark .navbar-nav .nav-link,
      .navbar-dark .navbar-nav .nav-link:focus { color: #fff }
      .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 }
      #wrapperlicious {
        margin: 0 auto;
        font: 0.9em 'Helvetica Neue', Helvetica, sans-serif;
        font-weight: normal;
        line-height: 1.5em;
        margin: 0;
        padding: 0;
      }
      #wrapperlicious h1 { font-size: 1.5em }
      #wrapperlicious h2 { font-size: 1.3em }
      #wrapperlicious h3 { font-size: 1.1em }
      #wrapperlicious h4 { font-size: 0.9em }
      #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3,
      #wrapperlicious h4, #wrapperlicious dt {
        color: #020202;
        margin-top: 1em;
        margin-bottom: 1em;
        position: relative;
        font-weight: bold;
      }
      #wrapperlicious a { color: inherit; text-decoration: underline }
      #wrapperlicious #toc { text-decoration: none }
      #wrapperlicious a:hover { color: #2a2a2a }
      #wrapperlicious a img { border: 0 }
      #wrapperlicious :not(pre) > code {
        color: inherit;
        background-color: rgba(0, 0, 0, 0.04);
        border-radius: 3px;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        padding: 0.3em;
      }
      #wrapperlicious dd {
        margin: 0;
        margin-left: 2em;
      }
      #wrapperlicious dt {
        color: #2a2a2a;
        font-weight: bold;
        margin-left: 0.9em;
      }
      #wrapperlicious p {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious li > p {
        margin-bottom: 0;
        margin-top: 0;
      }
      #wrapperlicious pre {
        border: 1px solid #c1c1c1;
        border-radius: 3px;
        font: 100% Consolas, Menlo, Monaco, monospace;
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious pre > code {
        display: block;
        background-color: #f6f6f6;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        line-height: 1.5em;
        text-align: left;
        white-space: pre;
        padding: 1em;
      }
      #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious ul {
        list-style-type: square;
      }
      #wrapperlicious ul ul {
        margin-bottom: 0px;
        margin-top: 0px;
      }
      #footer {
        font-size: 0.8em;
        padding-top: 0.5em;
        text-align: center;
      }
      #more {
        display: inline;
        font-size: 0.8em;
      }
      #perldocdiv {
        background-color: #fff;
        border: 1px solid #c1c1c1;
        border-bottom-left-radius: 5px;
        border-bottom-right-radius: 5px;
        margin-left: auto;
        margin-right: auto;
        padding: 3em;
        padding-top: 1em;
        max-width: 960px;
      }
      #moduleversion { float: right }
      #wrapperlicious .leading-notice {
        font-style: italic;
        padding-left: 1em;
        margin-top: 1em;
        margin-bottom: 1em;
      }
      #wrapperlicious .permalink {
        display: none;
        left: -0.75em;
        position: absolute;
        padding-right: 0.25em;
        text-decoration: none;
      }
      #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink,
      #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink,
      #wrapperlicious dt:hover .permalink {
        display: block;
      }
    </style>
    <!-- Global site tag (gtag.js) - Google Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-KVNWBNT5FB');
      gtag('config', 'UA-50555-3');
    </script>
  </head>
  <body>
    <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
  <a class="navbar-brand" href="https://perldoc.perl.org/">Perldoc Browser</a>
  <div class="collapse navbar-collapse" id="navbarNav">
    <ul class="navbar-nav mr-auto">
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="perlandroid.html#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.35.0</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-stable">
          <a class="dropdown-item" href="https://perldoc.perl.org/perlandroid">Latest</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.2/perlandroid">5.38.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.1/perlandroid">5.38.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0/perlandroid">5.38.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.3/perlandroid">5.36.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.2/perlandroid">5.36.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.1/perlandroid">5.36.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.0/perlandroid">5.36.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.3/perlandroid">5.34.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.2/perlandroid">5.34.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.1/perlandroid">5.34.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.0/perlandroid">5.34.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.1/perlandroid">5.32.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.0/perlandroid">5.32.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.3/perlandroid">5.30.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.2/perlandroid">5.30.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.1/perlandroid">5.30.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.0/perlandroid">5.30.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.3/perlandroid">5.28.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.2/perlandroid">5.28.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.1/perlandroid">5.28.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.0/perlandroid">5.28.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.3/perlandroid">5.26.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.2/perlandroid">5.26.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.1/perlandroid">5.26.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.0/perlandroid">5.26.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.4/perlandroid">5.24.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.3/perlandroid">5.24.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.2/perlandroid">5.24.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.1/perlandroid">5.24.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.0/perlandroid">5.24.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.4/perlandroid">5.22.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.3/perlandroid">5.22.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.2/perlandroid">5.22.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.1/perlandroid">5.22.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.0/perlandroid">5.22.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.3/perlandroid">5.20.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.2/perlandroid">5.20.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.1/perlandroid">5.20.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.0/perlandroid">5.20.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.4/perlandroid">5.18.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.3/perlandroid">5.18.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.2/perlandroid">5.18.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.1/perlandroid">5.18.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.0/perlandroid">5.18.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.3/perlandroid">5.16.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.2/perlandroid">5.16.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.1/perlandroid">5.16.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.0/perlandroid">5.16.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.4/perlandroid">5.14.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.3/perlandroid">5.14.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.2/perlandroid">5.14.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.1/perlandroid">5.14.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.0/perlandroid">5.14.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.5/perlandroid">5.12.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.4/perlandroid">5.12.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.3/perlandroid">5.12.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.2/perlandroid">5.12.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.1/perlandroid">5.12.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.0/perlandroid">5.12.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.1/perlandroid">5.10.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.0/perlandroid">5.10.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.9/perlandroid">5.8.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.8/perlandroid">5.8.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.7/perlandroid">5.8.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.6/perlandroid">5.8.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.5/perlandroid">5.8.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.4/perlandroid">5.8.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.3/perlandroid">5.8.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.2/perlandroid">5.8.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.1/perlandroid">5.8.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.0/perlandroid">5.8.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.2/perlandroid">5.6.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.1/perlandroid">5.6.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.0/perlandroid">5.6.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_04/perlandroid">5.005_04</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_03/perlandroid">5.005_03</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_02/perlandroid">5.005_02</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_01/perlandroid">5.005_01</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005/perlandroid">5.005</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="perlandroid.html#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-dev">
          <a class="dropdown-item" href="https://perldoc.perl.org/blead/perlandroid">blead</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.6/perlandroid">5.39.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.5/perlandroid">5.39.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.4/perlandroid">5.39.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.3/perlandroid">5.39.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.2/perlandroid">5.39.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.1/perlandroid">5.39.1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC2/perlandroid">5.38.0-RC2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC1/perlandroid">5.38.0-RC1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.11/perlandroid">5.37.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.10/perlandroid">5.37.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.9/perlandroid">5.37.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.8/perlandroid">5.37.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.7/perlandroid">5.37.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.6/perlandroid">5.37.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.5/perlandroid">5.37.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.4/perlandroid">5.37.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.3/perlandroid">5.37.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.2/perlandroid">5.37.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.1/perlandroid">5.37.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.0/perlandroid">5.37.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.11/perlandroid">5.35.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.10/perlandroid">5.35.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.9/perlandroid">5.35.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.8/perlandroid">5.35.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.7/perlandroid">5.35.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.6/perlandroid">5.35.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.5/perlandroid">5.35.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.4/perlandroid">5.35.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.3/perlandroid">5.35.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.2/perlandroid">5.35.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.1/perlandroid">5.35.1</a>
          <a class="dropdown-item active" href="perlandroid.html">5.35.0</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="perlandroid.html#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-nav">
          <a class="dropdown-item" href="perl.html">Perl</a>
          <a class="dropdown-item" href="perlintro.html">Intro</a>
          <a class="dropdown-item" href="perl.html#Tutorials">Tutorials</a>
          <a class="dropdown-item" href="perlfaq.html">FAQs</a>
          <a class="dropdown-item" href="perl.html#Reference-Manual">Reference</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlop.html">Operators</a>
          <a class="dropdown-item" href="functions.html">Functions</a>
          <a class="dropdown-item" href="variables.html">Variables</a>
          <a class="dropdown-item" href="modules.html">Modules</a>
          <a class="dropdown-item" href="perlutil.html">Utilities</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlcommunity.html">Community</a>
          <a class="dropdown-item" href="perlhist.html">History</a>
        </div>
      </li>
    </ul>
    <ul class="navbar-nav">
      <script>
        function set_expand (expand) {
          var perldocdiv = document.getElementById('perldocdiv');
          var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width');
          var expanded = (width == '' || width == 'none') ? true : false;
          if (expand === null) {
            expand = !expanded;
          }
          if ((expand && !expanded) || (!expand && expanded)) {
            perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px');
            var button_classlist = document.getElementById('content-expand-button').classList;
            if (expand) {
              button_classlist.add('btn-light');
              button_classlist.remove('btn-outline-light');
            } else {
              button_classlist.add('btn-outline-light');
              button_classlist.remove('btn-light');
            }
          }
          return expand;
        }
        function toggle_expand () {
          var expand = set_expand(null);
          document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC';
        }
        function read_expand () {
          return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 });
        }
        if (document.readyState === 'loading') {
          document.addEventListener('DOMContentLoaded', function () {
            if (read_expand()) {
              set_expand(true);
            }
          });
        } else if (read_expand()) {
          set_expand(true);
        }
      </script>
      <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-2" onclick="toggle_expand()">Expand</button>
    <ul>
    <form class="form-inline" method="get" action="https://perldoc.perl.org/5.35.0/search">
      <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search">
    </form>
  </div>
</nav>

    <div id="wrapperlicious" class="container-fluid">
      <div id="perldocdiv">
        <div id="links">
          <a href="perlandroid.html">perlandroid</a>
          <div id="more">
            (<a href="perlandroid.txt">source</a>,
            <a href="https://metacpan.org/pod/perlandroid">CPAN</a>)
          </div>
        </div>
        <div class="leading-notice">
          You are viewing the version of this documentation from Perl 5.35.0.
            This is a development version of Perl.
        </div>
        <h1><a id="toc">CONTENTS</a></h1>
                  <ul>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#NAME">NAME</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#SYNOPSIS">SYNOPSIS</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#DESCRIPTION">DESCRIPTION</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Cross-compilation">Cross-compilation</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Get-the-Android-Native-Development-Kit-(NDK)">Get the Android Native Development Kit (NDK)</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Determine-the-architecture-you&#39;ll-be-cross-compiling-for">Determine the architecture you&#39;ll be cross-compiling for</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Set-up-a-standalone-toolchain">Set up a standalone toolchain</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#adb-or-ssh?">adb or ssh?</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#adb">adb</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#ssh">ssh</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Configure-and-beyond">Configure and beyond</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Notes">Notes</a>
              </li>
          </ul>

              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Native-Builds">Native Builds</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#CCTools">CCTools</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#Termux">Termux</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="perlandroid.html#AUTHOR">AUTHOR</a>
              </li>
          </ul>

      <h1 id="NAME"><a class="permalink" href="perlandroid.html#NAME">#</a>NAME</h1>

<p>perlandroid - Perl under Android</p>

<h1 id="SYNOPSIS"><a class="permalink" href="perlandroid.html#SYNOPSIS">#</a>SYNOPSIS</h1>

<p>The first portions of this document contains instructions to cross-compile Perl for Android 2.0 and later, using the binaries provided by Google. The latter portions describe how to build perl native using one of the toolchains available on the Play Store.</p>

<h1 id="DESCRIPTION"><a class="permalink" href="perlandroid.html#DESCRIPTION">#</a>DESCRIPTION</h1>

<p>This document describes how to set up your host environment when attempting to build Perl for Android.</p>

<h1 id="Cross-compilation"><a class="permalink" href="perlandroid.html#Cross-compilation">#</a><a id="Cross"></a>Cross-compilation</h1>

<p>These instructions assume an Unixish build environment on your host system; they&#39;ve been tested on Linux and OS X, and may work on Cygwin and MSYS. While Google also provides an NDK for Windows, these steps won&#39;t work native there, although it may be possible to cross-compile through different means.</p>

<p>If your host system&#39;s architecture is 32 bits, remember to change the <code>x86_64</code>&#39;s below to <code>x86</code>&#39;s. On a similar vein, the examples below use the 4.8 toolchain; if you want to use something older or newer (for example, the 4.4.3 toolchain included in the 8th revision of the NDK), just change those to the relevant version.</p>

<h2 id="Get-the-Android-Native-Development-Kit-(NDK)"><a class="permalink" href="perlandroid.html#Get-the-Android-Native-Development-Kit-(NDK)">#</a><a id="Get"></a><a id="Get-the-Android-Native-Development-Kit-NDK"></a>Get the Android Native Development Kit (NDK)</h2>

<p>You can download the NDK from <a href="https://developer.android.com/tools/sdk/ndk/index.html">https://developer.android.com/tools/sdk/ndk/index.html</a>. You&#39;ll want the normal, non-legacy version.</p>

<h2 id="Determine-the-architecture-you&#39;ll-be-cross-compiling-for"><a class="permalink" href="perlandroid.html#Determine-the-architecture-you&#39;ll-be-cross-compiling-for">#</a><a id="Determine"></a><a id="Determine-the-architecture-youll-be-cross-compiling-for"></a>Determine the architecture you&#39;ll be cross-compiling for</h2>

<p>There&#39;s three possible options: arm-linux-androideabi for ARM, mipsel-linux-android for MIPS, and simply x86 for x86. As of 2014, most Android devices run on ARM, so that is generally a safe bet.</p>

<p>With those two in hand, you should add</p>

<pre><code>$ANDROID_NDK/toolchains/$TARGETARCH-4.8/prebuilt/`uname | tr &#39;[A-Z]&#39; &#39;[a-z]&#39;`-x86_64/bin</code></pre>

<p>to your <code>PATH</code>, where <code>$ANDROID_NDK</code> is the location where you unpacked the NDK, and <code>$TARGETARCH</code> is your target&#39;s architecture.</p>

<h2 id="Set-up-a-standalone-toolchain"><a class="permalink" href="perlandroid.html#Set-up-a-standalone-toolchain">#</a><a id="Set"></a>Set up a standalone toolchain</h2>

<p>This creates a working sysroot that we can feed to Configure later.</p>

<pre><code>$ export ANDROID_TOOLCHAIN=/tmp/my-toolchain-$TARGETARCH
$ export SYSROOT=$ANDROID_TOOLCHAIN/sysroot
$ $ANDROID_NDK/build/tools/make-standalone-toolchain.sh \
        --platform=android-9 \
        --install-dir=$ANDROID_TOOLCHAIN \
        --system=`uname | tr &#39;[A-Z]&#39; &#39;[a-z]&#39;`-x86_64 \
        --toolchain=$TARGETARCH-4.8</code></pre>

<h2 id="adb-or-ssh?"><a class="permalink" href="perlandroid.html#adb-or-ssh?">#</a><a id="adb1"></a><a id="adb-or-ssh"></a>adb or ssh?</h2>

<p>adb is the Android Debug Bridge. For our purposes, it&#39;s basically a way of establishing an ssh connection to an Android device without having to install anything on the device itself, as long as the device is either on the same local network as the host, or it is connected to the host through USB.</p>

<p>Perl can be cross-compiled using either adb or a normal ssh connection; in general, if you can connect your device to the host using a USB port, or if you don&#39;t feel like installing an sshd app on your device, you may want to use adb, although you may be forced to switch to ssh if your device is not rooted and you&#39;re unlucky -- more on that later. Alternatively, if you&#39;re cross-compiling to an emulator, you&#39;ll have to use adb.</p>

<h3 id="adb"><a class="permalink" href="perlandroid.html#adb">#</a>adb</h3>

<p>To use adb, download the Android SDK from <a href="https://developer.android.com/sdk/index.html">https://developer.android.com/sdk/index.html</a>. The &quot;SDK Tools Only&quot; version should suffice -- if you downloaded the ADT Bundle, you can find the sdk under <i>$ADT_BUNDLE/sdk/</i>.</p>

<p>Add <i>$ANDROID_SDK/platform-tools</i> to your <code>PATH</code>, which should give you access to adb. You&#39;ll now have to find your device&#39;s name using <code>adb devices</code>, and later pass that to Configure through <code>-Dtargethost=$DEVICE</code>.</p>

<p>However, before calling Configure, you need to check if using adb is a viable choice in the first place. Because Android doesn&#39;t have a <i>/tmp</i>, nor does it allow executables in the sdcard, we need to find somewhere in the device for Configure to put some files in, as well as for the tests to run in. If your device is rooted, then you&#39;re good. Try running these:</p>

<pre><code>$ export TARGETDIR=/mnt/asec/perl
$ adb -s $DEVICE shell &quot;echo sh -c &#39;\&quot;mkdir $TARGETDIR\&quot;&#39; | su --&quot;</code></pre>

<p>Which will create the directory we need, and you can move on to the next step. <i>/mnt/asec</i> is mounted as a tmpfs in Android, but it&#39;s only accessible to root.</p>

<p>If your device is not rooted, you may still be in luck. Try running this:</p>

<pre><code>$ export TARGETDIR=/data/local/tmp/perl
$ adb -s $DEVICE shell &quot;mkdir $TARGETDIR&quot;</code></pre>

<p>If the command works, you can move to the next step, but beware: <b>You&#39;ll have to remove the directory from the device once you are done! Unlike <i>/mnt/asec</i>, <i>/data/local/tmp</i> may not get automatically garbage collected once you shut off the phone</b>.</p>

<p>If neither of those work, then you can&#39;t use adb to cross-compile to your device. Either try rooting it, or go for the ssh route.</p>

<h3 id="ssh"><a class="permalink" href="perlandroid.html#ssh">#</a>ssh</h3>

<p>To use ssh, you&#39;ll need to install and run a sshd app and set it up properly. There are several paid and free apps that do this rather easily, so you should be able to spot one on the store. Remember that Perl requires a passwordless connection, so set up a public key.</p>

<p>Note that several apps spew crap to stderr every time you connect, which can throw off Configure. You may need to monkeypatch the part of Configure that creates <code>run-ssh</code> to have it discard stderr.</p>

<p>Since you&#39;re using ssh, you&#39;ll have to pass some extra arguments to Configure:</p>

<pre><code>-Dtargetrun=ssh -Dtargethost=$TARGETHOST -Dtargetuser=$TARGETUSER -Dtargetport=$TARGETPORT</code></pre>

<h2 id="Configure-and-beyond"><a class="permalink" href="perlandroid.html#Configure-and-beyond">#</a><a id="Configure"></a>Configure and beyond</h2>

<p>With all of the previous done, you&#39;re now ready to call Configure.</p>

<p>If using adb, a &quot;basic&quot; Configure line will look like this:</p>

<pre><code>$ ./Configure -des -Dusedevel -Dusecrosscompile -Dtargetrun=adb \
    -Dcc=$TARGETARCH-gcc   \
    -Dsysroot=$SYSROOT     \
    -Dtargetdir=$TARGETDIR \
    -Dtargethost=$DEVICE</code></pre>

<p>If using ssh, it&#39;s not too different -- we just change targetrun to ssh, and pass in targetuser and targetport. It ends up looking like this:</p>

<pre><code>$ ./Configure -des -Dusedevel -Dusecrosscompile -Dtargetrun=ssh \
    -Dcc=$TARGETARCH-gcc        \
    -Dsysroot=$SYSROOT          \
    -Dtargetdir=$TARGETDIR      \
    -Dtargethost=&quot;$TARGETHOST&quot;  \
    -Dtargetuser=$TARGETUSER    \
    -Dtargetport=$TARGETPORT</code></pre>

<p>Now you&#39;re ready to run <code>make</code> and <code>make test</code>!</p>

<p>As a final word of warning, if you&#39;re using adb, <code>make test</code> may appear to hang; this is because it doesn&#39;t output anything until it finishes running all tests. You can check its progress by logging into the device, moving to <i>$TARGETDIR</i>, and looking at the file <i>output.stdout</i>.</p>

<h3 id="Notes"><a class="permalink" href="perlandroid.html#Notes">#</a>Notes</h3>

<ul>

<li><p>If you are targetting x86 Android, you will have to change <code>$TARGETARCH-gcc</code> to <code>i686-linux-android-gcc</code>.</p>

</li>
<li><p>On some older low-end devices -- think early 2.2 era -- some tests, particularly <i>t/re/uniprops.t</i>, may crash the phone, causing it to turn itself off once, and then back on again.</p>

</li>
</ul>

<h1 id="Native-Builds"><a class="permalink" href="perlandroid.html#Native-Builds">#</a><a id="Native"></a>Native Builds</h1>

<p>While Google doesn&#39;t provide a native toolchain for Android, you can still get one from the Play Store.</p>

<h2 id="CCTools"><a class="permalink" href="perlandroid.html#CCTools">#</a>CCTools</h2>

<p>You may be able to get the CCTools app, which is free. Keep in mind that you want a full toolchain; some apps tend to default to installing only a barebones version without some important utilities, like ar or nm.</p>

<p>Once you have the toolchain set up properly, the only remaining hurdle is actually locating where in the device it was installed in. For example, CCTools installs its toolchain in <i>/data/data/com.pdaxrom.cctools/root/cctools</i>. With the path in hand, compiling perl is little more than:</p>

<pre><code>export SYSROOT=&lt;location of the native toolchain&gt;
export LD_LIBRARY_PATH=&quot;$SYSROOT/lib:`pwd`:`pwd`/lib:`pwd`/lib/auto:$LD_LIBRARY_PATH&quot;
sh Configure -des -Dsysroot=$SYSROOT -Alibpth=&quot;/system/lib /vendor/lib&quot;</code></pre>

<h2 id="Termux"><a class="permalink" href="perlandroid.html#Termux">#</a>Termux</h2>

<p><a href="https://termux.com/">Termux</a> provides an Android terminal emulator and Linux environment. It comes with a cross-compiled perl already installed.</p>

<p>Natively compiling perl 5.30 or later should be as straightforward as:</p>

<pre><code class="plaintext">sh Configure -des -Alibpth=&quot;/system/lib /vendor/lib&quot;</code></pre>

<p>This certainly works on Android 8.1 (Oreo) at least...</p>

<h1 id="AUTHOR"><a class="permalink" href="perlandroid.html#AUTHOR">#</a>AUTHOR</h1>

<p>Brian Fraser &lt;fraserbn@gmail.com&gt;</p>


      </div>
      <div id="footer">
        <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p>

<p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p>


      </div>
    </div>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script>
    <script src="../highlight.pack.js"></script>
    <script>hljs.highlightAll();</script>
  </body>
</html>
